FontPicker（字体选择器） PRO#

FontPicker 命名空间提供了在系统中选择字体的能力。 它会调用系统字体选择器，让用户从可用字体列表中选取字体，并返回所选字体的 PostScript 名称。

概述#

在某些场景中（如自定义编辑器、文本渲染、样式设置等），需要用户选择字体。 FontPicker 提供了一个简洁的接口，可在脚本中异步调用系统字体选择器并获取结果。

方法#

pickFont(): Promise<string | null>#

打开系统字体选择器，允许用户选择字体。 返回一个 Promise，当用户选择完成或取消时解析为结果。

返回值：

• string：所选字体的 PostScript 名称（例如 "Helvetica-Bold"、"KaitiSC-Regular" 等）。
• null：用户取消选择时返回。

示例#

1const fontPostscriptName = await FontPicker.pickFont()
2if (fontPostscriptName == null) {
3  // 用户取消了字体选择
4  console.log("Font selection canceled")
5} else {
6  console.log("Selected font:", fontPostscriptName)
7}

示例输出：

使用说明#

• 返回的字体名称可直接用于需要指定字体的场景，如文本渲染或 UI 显示。
• 若用户取消选择，返回值为 null，调用方应当进行相应处理。
• 字体选择器展示的字体取决于系统中已安装的字体，包括系统预装与用户导入字体。

小结#